<!doctype HTML public "-//W3C//DTD HTML 4.0 Frameset//EN">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<meta name="generator" content="Adobe RoboHelp - www.adobe.com">
<title>Defining an RSS Reader widget</title>
<link rel="stylesheet" href="RoboHTML_ns.css"><script type="text/javascript" language="JavaScript" title="WebHelpSplitCss">
<!--
if (navigator.appName !="Netscape")
{   document.write("<link rel='stylesheet' href='RoboHTML.css'>");}
//-->
</script>
<style type="text/css">
<!--
h1.whs1 { font-size:11pt; }
p.whs2 { font-size:9pt; }
p.whs3 { font-size:9pt; margin-left:40px; }
img_whs4 { border:none; width:398px; height:302px; border-style:none; }
p.whs5 { font-weight:bold; font-size:9pt; }
ul.whs6 { list-style:disc; }
p.whs7 { font-size:9pt; font-weight:normal; }
p.whs8 { font-size:10pt; font-weight:bold; }
ol.whs9 { list-style:decimal; }
p.whs10 { font-size:9pt; margin-top:6px; margin-bottom:6px; }
p.whs11 { margin-top:6px; margin-bottom:6px; font-weight:bold; margin-left:40px; }
p.whs12 { margin-top:6px; margin-bottom:6px; margin-left:24px; }
ul.whs13 { list-style:decimal; }
p.whs14 { margin-top:6px; margin-bottom:6px; margin-left:40px; }
ol.whs15 { list-style:disc; }
p.whs16 { font-size:9pt; margin-top:6px; margin-bottom:6px; font-weight:normal; }
p.whs17 { margin-top:6px; margin-bottom:6px; margin-left:120px; }
p.whs18 { margin-left:40px; }
h3.whs19 { margin-left:48px; }
p.whs20 { font-family:Arial, sans-serif; }
p.whs21 { font-family:Arial, sans-serif; font-weight:normal; }
p.whs22 { margin-top:6px; margin-bottom:6px; font-weight:bold; font-size:9pt; }
-->
</style><script type="text/javascript" language="JavaScript" title="WebHelpInlineScript">
<!--
function reDo() {
  if (innerWidth != origWidth || innerHeight != origHeight)
     location.reload();
}
if ((parseInt(navigator.appVersion) == 4) && (navigator.appName == "Netscape")) {
	origWidth = innerWidth;
	origHeight = innerHeight;
	onresize = reDo;
}
onerror = null; 
//-->
</script>
<style type="text/css">
<!--
div.WebHelpPopupMenu { position:absolute; left:0px; top:0px; z-index:4; visibility:hidden; }
-->
</style><script type="text/javascript" language="javascript1.2" src="whmsg.js"></script>
<script type="text/javascript" language="javascript" src="whver.js"></script>
<script type="text/javascript" language="javascript1.2" src="whproxy.js"></script>
<script type="text/javascript" language="javascript1.2" src="whutils.js"></script>
<script type="text/javascript" language="javascript1.2" src="whlang.js"></script>
<script type="text/javascript" language="javascript1.2" src="whtopic.js"></script>
</head>
<body><script type="text/javascript" language="javascript1.2">
<!--
if (window.gbWhTopic)
{
	if (window.addTocInfo)
	{
	addTocInfo("Creating and modifying documents and dashboards\nProviding Flash-based analysis and interactivity: Widgets\nCreating an RSS Reader widget");
addButton("show",BTN_TEXT,"Show","","","","",0,0,"","","");

	}
	if (window.writeBtnStyle)
		writeBtnStyle();

	if (window.writeIntopicBar)
		writeIntopicBar(1);

	if(1)
	{
	
	}

	if (window.setRelStartPage)
	{
	setRelStartPage("MicroStrategy_Web_Help.htm");

		autoSync(1);
		sendSyncInfo();
		sendAveInfoOut();
	}
}
else
	if (window.gbIE4)
		document.location.reload();

//-->
</script>
<h1 class="whs1">Creating an RSS Reader widget</h1>
<p class="whs2"><span style="font-size: 9pt;"><font size=1 style="font-size:9pt;">RSS (Really Simple 
 Syndication) is a data format used to display updated Web content when 
 you click a URL. An RSS document is called a feed and it contains either 
 a summary of the content from an associated website or the full text. 
 </font></span></p>
<p class="whs2">The RSS Reader widget helps provide a 360-degree 
 view of your business by allowing you to compare and contrast data in 
 your dashboard with information from external news feed sources. The widget 
 retrieves news from an RSS news feed and displays it alongside the other 
 components of your dashboard. The RSS feed is automatically reloaded to 
 display the most up-to-date news about a variety of topics that you specify.</p>
<p class="whs2">&nbsp;</p>
<p class="whs3"><img src="images/defining_RSS_reader_widget.gif" width="398px" height="302px" border="0" class="img_whs4"></p>
<p class="whs2">&nbsp;</p>
<p class="whs2"><span style="font-size: 9pt;"><font size=1 style="font-size:9pt;">You can use RSS 
 Reader widgets on a dashboard to view and update your favorite RSS news 
 feeds as you analyze grid reports, graphs, and other objects in the dashboard. 
 </font></span></p>
<p class="whs2">The RSS Reader widget helps provide context 
 to your business data. For example, you are viewing a dashboard with sales 
 figures for some of your local customers. You can configure the RSS Reader 
 widget to display up-to-the-minute news about those customers. This allows 
 you to view both sales data and news information about the same customers, 
 in one place. Consider another example. One of your reports provides sales 
 figures for a group of stores in northern California. Using an RSS feed, 
 you can display local industry news for that specific region, which can 
 provide valuable background information about those sales figures.<span 
 style="font-size: 9pt;"> <font size=1 style="font-size:9pt;"></font></span></p>
<p class="whs5">RSS Reader requirements</p>
<ul type="disc" class="whs6">
	
<li class=p><p class="whs7">The RSS 
 Reader &nbsp;widget supports both RSS 1.0 and RSS 2.0 
 formats.</p></li>
	
<li class=p><p class="whs2">Unlike other widgets, the RSS 
 Reader widget does not require attributes or metrics on the Grid/Graph, 
 unless you set the widget as a target of an attribute selector in the 
 dashboard.</p></li>
</ul>
<p class="whs8">To create and add an RSS 
 Reader widget in a document</p>
<ol type="1" class="whs9">
	
<li style=" font-size: 9pt; " class=p><p class="whs10">Open 
 the document in <span style="font-weight: bold;"><B>Design</B></span> or <span 
 style="font-weight: bold;"><B>Editable Mode</B></span>. </p></li>
	
<li style=" font-size: 9pt; " class=p><p class="whs10">From 
 the <span style="font-weight: bold;"><B>Insert</B></span> menu, point to <span 
 style="font-weight: bold;"><B>Widgets</B></span>, and then select <span style="font-weight: bold;"><B>RSS 
 Reader</B></span>.</p></li>
</ol>
<ol start="3" type="1" class="whs9">
	
<li style=" font-size: 9pt; " class=p><p class="whs10">Click 
 the location on your document in which you want to place the widget (widgets 
 cannot be placed in the Detail section). The Grid/Graph is displayed. 
 A small icon is displayed at the bottom right of the Grid/Graph, identifying 
 the type of widget you added to the document.</p></li>
	
<li style=" font-size: 9pt; " class=p><p class="whs10">If 
 desired, resize the widget by clicking and dragging its handles.</p></li>
</ol>
<p class="whs11">Enable 
 the widget to be displayed</p>
<ol start="5" type="1" class="whs9">
	
<li style="margin-left: -20px;" class=p><p class="whs12">Enable 
 the widget to be viewed in one of two ways: </p></li>
	<ul type="1" class="whs13">
		
<li class=p-Topic-Text-Bulleted><p class=Topic-Text-Bulleted>Select 
 <span style="font-weight: bold;"><B>Flash Mode</B></span> from the <span style="font-weight: bold;"><B>Home</B></span> 
 menu.</p></li>
	</ul>
	<ul>
<li class=p-Topic-Text-Bulleted-2><p class=Topic-Text-Bulleted-2>If 
 Flash Mode is not available in the Home menu, you must make Flash Mode 
 available in the document. For steps, see 
<a href="Defining_available_display_modes.htm">Defining 
 which display modes are available to users</a>.</p></li>
	</ul>
	<ul type="1" class="whs13">
		
<li class=p-Topic-Text-Bulleted><p class=Topic-Text-Bulleted style="margin-top: 6px; margin-bottom: 6px;">Select 
 <span style="font-weight: bold;"><B>Interactive Mode</B></span> from the <span 
 style="font-weight: bold;"><B>Home</B></span> menu.</p></li>
		
<li class=p-Topic-Text-Bulleted-2><p class=Topic-Text-Bulleted-2>The 
 widget must be enabled to be displayed in non-Flash mode to be viewable 
 in Interactive Mode. For instructions to allow a widget to be displayed 
 in non-Flash mode, see 
<a href="Widget_non_Flash.htm">Determining how 
 a widget is rendered in non-Flash modes</a>.</p></li>
	</ul>
</ol>
<p class="whs11">Static 
 vs. dynamic feeds RSS feeds</p>
<p class="whs14">You 
 can configure an RSS Reader widget to display one of the following types 
 of RSS feeds:</p>
<ol type="disc" class="whs15">
	<ul type="disc" class="whs6">
		
<li class=p><p class="whs16"><span 
 style="font-weight: bold;"><B>Static RSS Feeds</B></span>: Static feeds display 
 a default set of news about a general topic, such as business or technology. 
 These feeds are considered static because their URLs are pre-configured 
 to display information on a single topic.</p></li>
		
<li class=p><p class="whs16"><span 
 style="font-weight: bold;"><B>Dynamic RSS Feeds</B></span>: Dynamic feeds are 
 URLs that have been modified to display information about a specific topic. 
 You can use these versatile analysis tools in the RSS Reader widget to 
 view:</p></li>
		<ul type="disc" class="whs6">
			
<li class=p><p class="whs16"><span 
 style="font-weight: bold;"><B>News related to a specific topic</B></span>: For 
 example, to use a Yahoo! RSS feed to search for and display news related 
 to MicroStrategy, you must use a URL such as the following:</p></li>
		</ul>
	</ul>
</ol>
<p class="whs17">http://news.search.yahoo.com/news/rss?p=mstr&amp;ei=UTF-8&amp;fl=0&amp;x=wrt</p>
<p class="whs17">Similarly, 
 to search on retail sales, you can modify the URL as follows:</p>
<p class="whs17">http://news.search.yahoo.com/news/rss?p=Retail+Sales&amp;ei=UTF-8&amp;fl=0&amp;x=wrt</p>
<p class="whs17"><span 
 style="font-weight: bold;"><B>Note</B></span>: Use a + character to include a 
 space between words.</p>
<p class="whs17">Some 
 URLs, such as the ones above, include a parameter for UTF. If you have 
 to specify this parameter in a URL, use UTF-8 encoding.</p>
<ol type="disc" class="whs15">
	<ol type="disc" class="whs15">
		<ul type="disc" class="whs6">
			
<li class=p><p class="whs16"><span 
 style="font-weight: bold;"><B>News related to a specific attribute, document, 
 or dataset</B></span>: The RSS Reader widget can automatically display news 
 related to any attribute in your dashboard. For example, the name of a 
 digital music player is selected from the Item attribute in a report. 
 News related to that digital music player is retrieved from the RSS news 
 source and displayed in the widget.</p></li>
		</ul>
	</ol>
</ol>
<p class="whs17">To 
 display news about an attribute element, you must use a dynamic RSS feed 
 URL in the widget. For example, if you are using a Yahoo! RSS feed and 
 want to display news for any category selected from the Category attribute, 
 you must define the RSS feed's URL as follows:</p>
<p class="whs17">http://news.search.yahoo.com/news/rss?p={[Category]}&amp;ei=UTF-8&amp;fl=0&amp;x=wrt</p>
<p class="whs18"><span style="font-weight: normal;">Depending 
 on a feed’s RSS provider, you can create a dynamic RSS feed by either 
 modifying a static RSS feed's URL or using a new, dynamic URL. The method 
 to use depends on the provider of the RSS feed. Regardless of the method 
 you use, you must enter appropriate parameters in the RSS feed’s URL to 
 retrieve and display news on a specific topic.</span> </p>
<h3 class="whs19">Specify the RSS feed to display in the widget</h3>
<p class="whs14">As the 
 document designer or administrator, you can specify the RSS feed to which 
 the widget will connect. You can also specify the number of news articles 
 that are displayed, the refresh frequency of the news articles, and other 
 options.</p>
<ol start="6" type="1" class="whs9">
	
<li style="font-size: 9pt; " class=p><p class="whs10">Right-click 
 the widget and select <span style="font-weight: bold;"><B>Properties</B></span>. 
 The Properties dialog box opens.</p></li>
	
<li style="font-size: 9pt; " class=p><p class="whs10">One 
 the <span style="font-weight: bold;"><B>General</B></span> tab, type the title 
 in the <span style="font-weight: bold;"><B>Feed Title</B></span> field &nbsp;to 
 create a title that appears at the top right of the widget.</p></li>
	
<li style="font-size: 9pt; " class=p><p class="whs10">Type 
 the URL for one of the following types of RSS feeds in the <span style="font-weight: bold;"><B>RSS 
 Feed URL</B></span> field. You can use only one RSS feed. </p></li>
</ol>
<ol type="disc" class="whs15">
	<ul type="disc" class="whs6">
		
<li class=p><p class="whs10">For 
 static RSS feeds, type the RSS feed's URL. For example, to view news from 
 the Yahoo! Business News RSS feed, enter the following: http://rss.news.yahoo.com/rss/business 
 </p></li>
		
<li class=p><p class="whs10">For 
 dynamic RSS feeds, specify the base URL, any language/country properties, 
 and one of the following: </p></li>
		<ul type="disc" class="whs6">
			
<li class=p><p class="whs10">To 
 display news about a specific topic, insert the topic into the URL’s query 
 parameter. </p></li>
			
<li class=p><p class="whs10">To 
 display news related to an attribute, document, or dataset, insert an 
 auto code for the object in the URL’s query parameter. To display news 
 for an attribute, you must also set the Grid/Graph as the target of the 
 attribute selector. For more information about widgets as selectors, see 
 
<a href="Widget_as_selector.htm">Using a widget as a selector</a>.</p></li>
		</ul>
	</ul>
</ol>
<ol start="10" type="1" class="whs9">
	
<li style="font-size: 9pt; " class=p><p class="whs10">Specify 
 the rate at which news items are automatically refreshed. Enter this value 
 in minutes in the <span style="font-weight: bold;"><B>Default Refresh Frequency</B></span> 
 field. </p></li>
	
<li style="font-size: 9pt; " class=p><p class="whs10">Enter 
 a number in the <span style="font-weight: bold;"><B>Items shown at a time</B></span> 
 field to specify the maximum number of news items that a user sees at 
 a time. The default value is set as ten.</p></li>
	
<li style="font-size: 9pt; " class=p><p class="whs10">Select 
 or clear the <span style="font-weight: bold;"><B>Open full article when clicked</B></span> 
 check box to determine whether a news article is opened in a new window 
 when it is selected in the widget.</p></li>
	
<li style="font-size: 9pt; " class=p><p class="whs10">If 
 the RSS feed is accessed through a proxy server, select the <span style="font-weight: bold;"><B>Use 
 Proxy</B></span> check box.</p></li>
	
<li style="font-size: 9pt; " class=p><p class="whs10">Click 
 <span style="font-weight: bold;"><B>Save</B></span> to apply the changes, then<span 
 style="margin-left: 0px;"> click </span><span style="margin-left: 0px; font-weight: bold;"><B>OK</B></span><span 
 style="margin-left: 0px;"> to save your changes and close the dialog box. 
 </span></p></li>
</ol>
<h2>Enabling an RSS Reader Widget to display online content when used offline</h2>
<p>If you are exporting a dashboard that contains an RSS Reader widget, 
 you must add the <span style="font-family: 'Courier New', monospace; font-size: 11pt;"><font size=3 style="font-size:11pt;">.MHT 
 </font></span><span style="font-family: Arial, sans-serif;">file to the list 
 of Adobe Flash Player trusted files on the client machine. The </span><span 
 style="font-family: 'Courier New', monospace; font-size: 11pt;"><font size=3 style="font-size:11pt;">.MHT </font></span><span 
 style="font-family: Arial, sans-serif;">file contains all of the data 
 required to make a widget that is displayed in Flash mode function properly 
 once it has been exported. For more information about exporting documents, 
 see 
<a href="Export_a_document.htm">Exporting a Document</a>.</span></p>
<p class="whs20"><span style="font-weight: bold;"><B>Warning:</B></span> 
 The third-party products discussed below are manufactured by vendors independent 
 of MicroStrategy, and the information provided is subject to change. Refer 
 to the appropriate third-party vendor documentation for updated Flash 
 Player support information.</p>
<p class="whs20"><span style="font-weight: bold;"><B>To 
 enable an RSS Widget to display online content when used offline</B></span></p>
<ol type="1" class="whs9">
	
<li style="font-weight: normal; font-family: Arial, sans-serif; " class=p><p class="whs20">Access the Macromedia support 
 site at 
<a href="http://www.macromedia.com/support/documentation/en/flashplayer/help/settings_manager04.html">http://www.macromedia.com/support/documentation/en/flashplayer/help/settings_manager04.html</a>.</p></li>
	
<li style=" font-family: Arial, sans-serif; " class=p><p class="whs20">From 
 the <span>&nbsp;</span><span style="font-weight: bold;"><B>Edit 
 locations </B></span><span>drop-down menu on the right, select </span><span 
 style="font-weight: bold;"><B>Add location</B></span><span>.</span></p></li>
	
<li style=" font-family: Arial, sans-serif; font-weight: normal; " 
 class=p><p class="whs21">Type 
 the location of the <span style="font-family: 'Courier New', monospace; font-size: 11pt;"><font size=3 style="font-size:11pt;">.MHT 
 </font></span>file in the textbox.</p></li>
	
<li style=" font-family: Arial, sans-serif; font-weight: normal; " 
 class=p><p class="whs21">Click 
 <span style="font-weight: bold;"><B>Confirm.</B></span></p></li>
	
<li style=" font-family: Arial, sans-serif; font-weight: normal; " 
 class=p><p class="whs21">Close 
 and reopen the dashboard or document that contains the widget.</p></li>
</ol>
<p class="whs22">Related 
 topics</p>
<ul type="disc" class="whs6">
	
<li class=p><p class="whs10"><span 
 style="font-size: 9pt; margin-top: 6px; margin-bottom: 6px;"><font size=1 style="font-size:9pt;">
<a href="Formatting_an_RSS_Reader_widget.htm">Formatting 
 an RSS Reader widget</a></font></span></p></li>
	
<li class=p><p class="whs10">
<a 
 href="Analyzing_data_in_a_RSS_Reader_widget.htm">Analyzing data in an 
 RSS Reader widget</a></p></li>
	
<li class=p><p class="whs10">
<a 
 href="Flash_Mode.htm">Working with documents in Flash Mode</a></p></li>
</ul>
<script type="text/javascript" language="javascript1.2">
<!--
highlightSearch();
if (window.writeIntopicBar)
	writeIntopicBar(0);
if(0)
{

}
//-->
</script>
</body>
</html>
